Harness Handbook: Making Evolving Agent Harnesses Readable,Navigable, and Editable
Harness Handbook：面向Agent框架演化的行为中心可读表示与渐进式代码定位
🧭 Agent harness 行为定位与编辑辅助
Tencent · Indiana University · University of Maryland, College Park · University of Georgia · National University of Singapore
通过静态分析+LLM自动构建行为手册并引导渐进披露，解决Agent harness修改中的行为定位瓶颈
📌 工作参考价值（4 点）
- 维护行为手册辅助搜推系统Agent harness迭代：在电商搜索推荐的多阶段pipeline（召回、粗排、精排、重排）中，Agent harness常跨模块分布，修改一个业务逻辑需定位多处代码。借鉴Harness Handbook思路，可对搜推系统Agent框架做静态分析+LLM结构化，自动生成行为-代码映射表，让开发者快速找到所有相关实现点。
- 用渐进披露降低LLM Agent的规划成本：BGPD从高级行为描述逐步引导到具体代码细节，可迁移到内部代码修改Agent（如用LLM规划代码变更）——先定位行为，再展开实现细节，节省推理token并提高编辑计划准确性。
- 强化行为定位验证机制：在实际的Agent harness变更中，引入对候选代码位置的静态验证，可避免LLM规划阶段产生幻觉导致的错误修改，这对高频迭代的电商大促策略调整很有价值。
- 拥抱行为为中心的文档化自动化：搜推Agent的prompt、工具调用、状态管理常分散在多个文件，可仿照此方法生成可读的“行为手册”，降低新人上手和跨团队协作的成本。